How to Add Page Numbers in a PDF

更新日期:7月 27, 2025

Translated

View the article in English

页码是在 PDF 文档的每一页指定的连续编号。页码是文档中导航的最重要组成部分之一。它们帮助读者定位特定的页面，并确定所阅读的页面。此外，页码还能便于文档内容的引述和引用。使用 IronPDF，将页码添加到 PDF 是一个简单的过程。

快速入门：轻松为 PDF 添加页码

使用 IronPDF 轻松地为您的 PDF 文档添加页码。只需几行 C# 代码即可将动态页码插入到页眉或页脚中，自定义其位置，并指定应在哪个页面显示。无论您是在处理新的 PDF 还是现有的 PDF，IronPDF 提供了一个简单而灵活的解决方案，以增强文档导航和组织。请按照指南快速在您的项目中实现页码。

Install IronPDF with NuGet Package Manager

PM > Install-Package IronPdf

Copy and run this code snippet.

new IronPdf.ChromePdfRenderer { RenderingOptions = { HtmlFooter = new IronPdf.HtmlHeaderFooter { HtmlFragment = "<center>{page}of{total-pages}</center>", DrawDividerLine = true } } }
     .RenderHtmlAsPdf("<h1>My multi‑page document</h1><div style='page‑break‑after:always;'></div><h1>Page 2</h1>")
     .SaveAs("numbered‑pages.pdf");

Deploy to test on your live environment

Start using IronPDF in your project today with a free trial

Free 30 day Trial

class="hsg-featured-snippet">

最小工作流程（5 步）

从 NuGet 下载 C# PDF 库
加载现有的 PDF 文档或渲染一个新的
在页眉和页脚中使用占位符字符串 {page} 和 {total-pages} 插入页码
将页码应用于特定页面或部分
查看生成的 PDF 文档

## 添加页码示例使用占位符字符串 `{page}` 和 `{total-pages}` 与 **TextHeaderFooter** 或 **HtmlHeaderFooter** 类结合使用，您可以添加当前页码和总页数。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/page-numbers-basic.cs ``` 上面代码生成的输出 PDF 如下所示：您还可以直接将带有页码占位符字符串的页眉和页脚添加到 **ChromePdfRenderer** 的渲染选项中。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/page-numbers-chromerenderer.cs ``` ## 为特定页面添加页码示例使用 IronPDF，您可以决定在哪里添加页码。您可以设置从某一页或特定组页（例如偶数页）开始添加页码。让我们准备我们的 PDF 文档以应用页码。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/page-numbers-preparation.cs ``` ### 偶数页索引基于前面的代码示例，以下代码将仅对偶数页码索引应用页码。由于我们正在过滤偶数页码索引，因此生成的 PDF 将仅对奇数页上应用编号。页码索引从零开始，而页码从一开始。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/page-numbers-even-pages.cs ``` ### 奇数页索引专门将页码添加到具有奇数索引编号的页面。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/page-numbers-odd-pages.cs ``` ### 仅最后一页仅为最后一页添加页码。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/page-numbers-last-page-only.cs ``` ### 仅第一页仅为第一页添加页码。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/page-numbers-first-page-only.cs ``` ### 跳过第一页在应用页眉时跳过第一页。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/page-numbers-skip-first-page.cs ``` ### 跳过第一页 And Don't Count it 跳过第一页，从第二页开始编号，将其视为第 1 页。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/page-numbers-skip-first-page-and-dont-count-it.cs ``` 要探索所有元数据选项，请访问[IronPDF Headers and Footers Guide](/how-to/headers-and-footers/#anchor-metadata-to-text-header-footer)。

常見問題解答

如何使用 C# 為 PDF 新增頁碼？

您可以使用 IronPDF 庫在 C# 中為 PDF 新增頁碼。首先，從 NuGet 下載 C# PDF 庫。然後，載入現有 PDF 或建立一個新 PDF，並在頁首或頁尾中使用佔位符字串{page}和{total-pages}插入頁碼。最後，儲存更新後的 PDF。

我可以自訂PDF檔案中頁碼的位置嗎？

是的，使用 IronPDF，您可以自訂 PDF 文件中頁碼的位置。您可以選擇僅為特定頁面新增頁碼，例如偶數索引頁或奇數索引頁，或僅將其套用於第一頁或最後一頁。

如何只在PDF檔案的偶數頁上加上頁碼？

若要使用 IronPDF 僅為 PDF 中的偶數頁新增頁碼，請依偶數索引篩選頁面，並在頁首或頁尾中設定所需的頁碼佔位符。這樣，頁碼就會套用在索引號為偶數的頁面。

是否可以將PDF檔案的頁碼從第二頁開始編號？

是的，使用 IronPDF，您可以跳過第一頁，並從第二頁開始編號。為此，請將頁首或頁尾設定為從第二頁開始套用，並使用佔位符字串來管理編號順序。

如何只在PDF檔案的最後一頁加上頁碼？

若要使用 IronPDF 僅為 PDF 的最後一頁添加頁碼，您可以設定頁首或頁腳，使其專門套用至最後一頁。這可以透過引用最後一頁的索引並設定頁碼的佔位符字串來實現。

在 PDF 頁碼中使用佔位符字串有什麼好處？

諸如{page}和{total-pages}之類的佔位符字串允許動態插入當前頁碼和總頁數。這使得頁碼管理更加靈活高效，尤其是在文件結構發生變化時。 IronPDF 利用這些佔位符來簡化頁碼流程。

如何在不影響首頁的情況下為PDF檔案新增頁碼？

若要在 IronPDF 中為 PDF 新增頁碼而不影響首頁，請將頁首或頁尾配置為從第二頁開始。此方法可確保首頁保持無頁碼狀態，而後續頁面則自動新增頁碼。

IronPDF 能否處理 HTML 內容和現有 PDF 的頁碼？

是的，IronPDF 可以處理 HTML 內容和現有 PDF 的頁碼。您可以使用IronPdf.ChromePdfRenderer將 HTML 渲染為 PDF 並新增頁碼，或修改現有 PDF 文檔，在頁首和頁尾中新增頁碼。

IronPDF 在新增頁碼時完全相容於 .NET 10？

是的－IronPDF 與 .NET 10 完全相容，讓您在 .NET 10 專案中使用頁首或頁尾以及佔位符字串{page}和{total-pages}新增頁碼，就像在早期的 .NET 版本一樣。

Jordi Bardia

立即與工程團隊聊天

軟體工程師

Jordi 在 Python、C# 和 C++ 上最得心應手，當他不在 Iron Software 展現技術時，便在做遊戲編程。在分担产品测测试，产品开发和研究的责任时，Jordi 为持续的产品改进增值。他说这种多样化的经验使他受到挑战并保持参与, 而这也是他与 Iron Software 中工作一大乐趣。Jordi 在佛罗里达州迈阿密长大，曾在佛罗里达大学学习计算机科学和统计学。

A PHP Error was encountered

Severity: Warning

Message: Illegal string offset 'name'

Filename: sections/author_component.php

Line Number: 70

Backtrace:

File: /var/www/ironpdf.com/application/views/main/sections/author_component.php
Line: 70
Function: _error_handler

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 63
Function: view

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 64
Function: main_view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/how-to/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

�

A PHP Error was encountered

Severity: Warning

Message: Illegal string offset 'linkedIn'

Filename: sections/author_component.php

Line Number: 73

Backtrace:

File: /var/www/ironpdf.com/application/views/main/sections/author_component.php
Line: 73
Function: _error_handler